home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / utility / pock51.zip / GENERAL.DOC < prev    next >
Text File  |  1997-07-26  |  11KB  |  258 lines
  1.                *************************
  2.                * General Documentation *
  3.                *************************
  4.  
  5.                PocketD Plus v5.1 (D.EXE)
  6.  
  7.       Directory Listing, Copy and File Management Program
  8.     PocketD (TM) Copyright Jeff Rollason, PocketWare (TM) 1990-1994
  9.               All Rights Reserved
  10.  
  11.  
  12.  Contents:
  13.  
  14.     (1) PocketD Plus and Shareware
  15.         ASP
  16.         Shareware
  17.         PocketD Plus
  18.         Trademarks
  19.  
  20.     (2) Special Tips and Speeding up PocketD
  21.  
  22.     (3) Design Compromises
  23.  
  24.     (4) Compatibility and Limitations
  25.  
  26.  
  27.  (1) >>>>> PocketD Plus and Shareware
  28.  
  29.  PocketD Plus is a shareware product. You may use the software for free
  30.  for  30  days.  If you  continue  to use it after this time  you  must
  31.  register it through PocketWare (See below).
  32.  
  33.              _______
  34.             ____|__     |               (R)
  35.          --|       |    |-------------------
  36.            |   ____|__  |  Association of
  37.            |  |       |_|  Shareware
  38.            |__|   o   |    Professionals
  39.          -----|   |   |---------------------
  40.               |___|___|    MEMBER
  41.  
  42.  
  43.  Jeff   Rollason   is  a  member  of  the  Association   of   Shareware
  44.  Professionals  (ASP).  ASP  wants  to  make sure  that  the  shareware
  45.  principle   works   for  you.  If  you  are  unable   to   resolve   a
  46.  shareware-related  problem with an ASP member by contacting the member
  47.  directly,  ASP  may be able to  help. The ASP Ombudsman can  help  you
  48.  resolve  a dispute or problem with an ASP member, but does not provide
  49.  technical  support  for  members'  products. Please write to  the  ASP
  50.  Ombudsman  at  545  Grover  Road,  Muskegon, MI  USA  49442-9427,  FAX
  51.  616-788-2765,  or send a CompuServe message via CompuServe Mail to ASP
  52.  Ombudsman 70007,3536.
  53.  
  54.              ****************************
  55.              *  The Shareware Principle *
  56.              ****************************
  57.  
  58.  Software  distrubuted  as Shareware allows  the user to try out  fully
  59.  working programs before buying.
  60.  
  61.  >>>>> THIS IS THE IDEAL WAY TO BUY SOFTWARE:
  62.  
  63.     It  has the benefit of giving users the chance to fully try out
  64.     whether a product is suitable for their needs without risking a
  65.     wasted  financial  outlay. The  software is also CHEAPER!  (See
  66.     below).
  67.  
  68.  >>>>> THIS IS THE IDEAL WAY TO SELL SOFTWARE:
  69.  
  70.     The  Shareware  Author  does  not  have the  overhead  of  high
  71.     advertising   or   distribution  costs,  as  the   product   is
  72.     self-promoting.  In consequence Shareware products can be  sold
  73.     at a lower price than conventional retailed software.
  74.  
  75.  >>>>> IS SHAREWARE SOFTWARE ANY GOOD?
  76.  
  77.     Yes!  The  proof  of  this  is  obvious.  Shareware  completely
  78.     dominates  many areas of software, such as file compression and
  79.     communications, where Shareware clearly lead the markets.
  80.  
  81.  >>>>> IS IT FREE?
  82.  
  83.     No!  Much  time and effort  is required to turn  programs  into
  84.     polished and documented products. So if you seriously intend to
  85.     use a Shareware product, then support it!
  86.  
  87.  
  88.          ************************************
  89.          * The Shareware version of PocketD *
  90.          ************************************
  91.  
  92.  The  Shareware  version of  D.EXE has a built-in  Registration  banner
  93.  screen  that will appear whenever  the user accesses the full  on-line
  94.  manual,  also  prompting  the  user  to input a 2  character  code  to
  95.  acknowledge  the  banner. The same  banner appears randomly 3% of  the
  96.  time  whenever D.EXE is run,  waiting for any key input or  continuing
  97.  anyway  after  60  seconds  (It  can therefore run  unattended  during
  98.  evaluation). MENUD.EXE has a similar mechanism.
  99.  
  100.  Users  must  refer  to  the  file VENDINFO.DIZ for the  DISCLAIMER  OF
  101.  WARRANTY and distribution restrictions.
  102.  
  103.                   TRADEMARKS
  104.  
  105.  All  trademarks  are acknowledged.  This and other  related  documents
  106.  refer to the following names, among others:
  107.  
  108. - OS/2 & PC-DOS are trademarks of International Business Machines Corp.
  109.   (IBM Inc.)
  110. - LIST  copyrighted by Vernon D. Buerg
  111. - Microsoft, Windows & MSDOS registered trademarks of the Microsoft Corp.
  112. - DIET  Written by Teddy Matsumoto
  113. - PKlite, PKzip, PKARC and PKPAK  trademarks of PKWARE Inc.
  114. - LZEXE copyrighted by Fabrice Bellard
  115. - ANARKEY copyrighted by Steve Calwas of Moderne Software
  116. - CED   Written by Christopher J. Dunford
  117. - NORTON trademark of Peter Norton
  118. - PCTOOLS copyrighted by Central Point Software, Inc.
  119. - LHA & LHARC copyrighted by H. Yoshizaki
  120. - ZOO   copyrighted program
  121. - ARC & SEA  copyrighted by SEA
  122. - ARJ   copyrighted by Robert K. Jung
  123. - DESQview copyrighted by Quarterdeck
  124. - 4DOS  copyrighted by J.P. Software
  125. - Novell NetWare copyright Novell
  126. - CompuServe registered trademark of CompuServe Inc.
  127.  
  128.  
  129.  (2) >>>>> Special tips and Speeding up PocketD
  130.  
  131.     PocketD  is intended for use from the command line. The user is
  132.     strongly  recommended  to use it  with one of the many  command
  133.     history  editors  such as CED  or ANARKEY. This will allow  the
  134.     user  to experiment with long command lines without needing  to
  135.     re-type command input.
  136.  
  137.     DOS  constrains the user to  inputing lines no longer than  128
  138.     characters  long.  This  is  a  serious constraint  when  using
  139.     multi-line  or  multiple  templates  or very large  numbers  of
  140.     filespecs.  A  way around  this  constraint is to make  use  of
  141.     user-defined parameters to build long lines. e.g.
  142.  
  143.         set a1=[echo Creating $n//md $n//pkunzip $w $n\]
  144.         set a2=[?Unpack ZIP file to its own subdir ?]
  145.  
  146.     which  could be used by  the following line to generate a  long
  147.     command  line that could not have been entered within a  single
  148.     line.
  149.         d programs.zip game*.zip util*.zip /- *temp  /a1 /a2
  150.  
  151.     Another solution to processing large numbers of files is to use
  152.     a "response" file, e.g.
  153.  
  154.         d <list [pkzip -m backup $w]R
  155.  
  156.     where  "list"  is a file  of any size containing the  filenames
  157.     (and paths) to be processed.
  158.  
  159.     Since  PocketD  (D.EXE)  can  be  slow  to  load and  run,  it
  160.     is  recommended   that  it  is   run  from  a ram disk   (e.g.
  161.     VDISK   or RAMDRIVE).  To further improve the  load speed,  the
  162.     user can  also aliase D to D:D (where D: is the ram drive).
  163.  
  164.     OS/2 Users! --> Look at the compatibility notes.
  165.  
  166.  
  167.  (3) >>>>> Design Compromises
  168.  
  169.     PocketD could have been designed differently.
  170.  
  171.     Many of its features could be expanded and made more exotic and
  172.     powerful.  For  example the  file viewer could  allow  wildcard
  173.     searches. D.EXE could make use of expanded memory and shell out
  174.         to  extended memory or  disk when running other programs.  File
  175.     copying could be made faster by buffering multiple files before
  176.     beginning a copy.
  177.  
  178.     All these are possible, but if implemented, the tiny 35k of the
  179.     (registered)  D.EXE program would be substantially bigger,  and
  180.     less attractive to those who need D.EXE to be very small.
  181.  
  182.     D.EXE  has  been carefully  designed to provide an  astonishing
  183.     range  of features within a truly tiny program. This has  meant
  184.     that  its  facilities  have  had  to be closely  integrated  to
  185.     achieve  the maximum utility for each code section added.  This
  186.     design  approach  has  been  very successful. D.EXE  cannot  be
  187.     completely  replaced  by any  other combination of  tool  sets,
  188.     despite  its small size. The program that does come closest  to
  189.     D.EXE in functionality has less than half the range of options,
  190.     but is over twice the size.
  191.  
  192.     One  particular  compromise  is  the  design of  the  directory
  193.     browser.  This traverses  subdirectories by re-invoking  D.EXE.
  194.     This  has the effect of limiting how deep the user can  browse,
  195.     only  about  9 levels on a  normal machine (or 8 if  called  by
  196.     MENUD).  The payoff has been the very small code size  increase
  197.     to  D.EXE,  also  the  compensation  by the useful  and  unique
  198.     ability  of D.EXE to search for and collect any group of  files
  199.     and  directories  from multiple  drives to be browsed within  a
  200.     single list.
  201.  
  202.     The  final compromise is the single letter option names, giving
  203.     parameter  strings  that are  often  hard to read. This  was  a
  204.     deliberate  decision to allow the user to combine large numbers
  205.     of  options without hitting the 128 byte command limit. In  the
  206.     long run, most users will also appreciate the reduced number of
  207.     keystrokes needed to input a command.
  208.  
  209.     Does PocketD provide the right things?
  210.  
  211.     I believe it does. PocketD 1.67 was developed from the feedback
  212.     of  just a few users. v5.1 has been developed from the feedback
  213.     from a much wider base, including reviewers and many registered
  214.     users,  and in consequence has been able to grow into a product
  215.     that closely satisifies the needs of a much more diverse group.
  216.  
  217.  
  218.  (4) >>>>> Compatibility and Limitations.
  219.  
  220.       o  PocketD  works  under  MS-DOS/PC-DOS 3.0 or later,  Windows 3,
  221.      Windows 95,  Windows NT, OS/2 and DESQview. LOng filenames are
  222.      only  supported for Windows  95. Moving files between  logical
  223.      drives  under OS/2 v2.0 will not work, because v2.0 has a  bug
  224.      which  prevents inter-drive moves in a DOS window from working
  225.      at  all. This may be fixed in v2.1. Users can safely speed  up
  226.      MOVE  within a drive by using the /.4 switch to turn off  OS/2
  227.      copy/move compatibility.
  228.  
  229.       o  PocketD  will  work  with  non-standard  display  sizes,  e.g.
  230.      132x44.  Note that DOS's ANSI.SYS does not, and may  therefore
  231.      prevent PocketD (and DIR) from working correctly.
  232.  
  233.       o  PocketD  can scan any number  of files and directories but  is
  234.      limited  to building lists  of about 1,200 names (except  when
  235.      using  /r or /e which can process any number). The  registered
  236.      version  includes DL.EXE which can handle 9,000 names (PocketD
  237.      can generate lists of unlimited length with the line "D /j").
  238.  
  239.       o  PocketD  needs  COMMAND.COM  to  be  available  when   running
  240.      external programs. It is strongly recommended that COMMAND.COM
  241.      is    made    resident    using   a   line   of    the    form
  242.      SHELL=C:\COMMAND.COM /p /e:1024  in CONFIG.SYS. This  provides
  243.      additional  environment  space,  which  PocketD  can  use  for
  244.      configuration, color and user-defined parameters.
  245.  
  246.       o  PocketD  does not need any external programs to see  filenames
  247.      inside  archives, but  will need the appropriate  de-archivers
  248.      such as PKUNZIP etc. if the user wants to view the contents of
  249.      files  during  browsing  (/Q or /q).  If  these  programs  are
  250.      missing,  then D.EXE will attempt to run them, fail, and  then
  251.      return to the browse display. If you are unsure about why this
  252.      fails,  then  use /q to  view the error, otherwise  the  error
  253.      message  will  be cleared from  the screen. If you  have  .LZH
  254.      archives  created by LHARC rather than the newer LHA, then you
  255.      should create a BAT file LHA.BAT with the line "LHARC %1 %2 %3
  256.      %4 %5" inside to allow D.EXE to view these files.
  257.  
  258.